Skip to content

Add LiteLLM integration documentation - #45740

Merged
silamon merged 23 commits into
home-assistant:nextfrom
luismalves:litellm-docs
Jul 18, 2026
Merged

Add LiteLLM integration documentation#45740
silamon merged 23 commits into
home-assistant:nextfrom
luismalves:litellm-docs

Conversation

@luismalves

@luismalves luismalves commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Proposed change

Add documentation for the new LiteLLM integration, which lets you use a self-hosted LiteLLM proxy (an OpenAI-compatible API in front of many model providers) as a conversation agent in Home Assistant. Documents the config flow (proxy URL and optional API key), prerequisites, model discovery, and the conversation-agent functionality.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI review requested due to automatic review settings June 3, 2026 22:17
@home-assistant home-assistant Bot added has-parent This PR has a parent PR in another repo next This PR goes into the next branch labels Jun 3, 2026
@netlify

netlify Bot commented Jun 3, 2026

Copy link
Copy Markdown

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 0278ef1
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6a5a0f10461ede00082d0a05
😎 Deploy Preview https://deploy-preview-45740--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds documentation for the new LiteLLM integration, explaining setup via the config flow and what functionality is provided (conversation agent via a self-hosted LiteLLM proxy).

Changes:

  • Introduces a new integration documentation page for LiteLLM.
  • Documents configuration fields (URL, optional API key) and prerequisites for running a proxy.
  • Describes supported functionality and removal steps.

Comment thread source/_integrations/litellm.markdown Outdated
Comment thread source/_integrations/litellm.markdown Outdated
Comment thread source/_integrations/litellm.markdown
Rephrase the Prerequisites paragraph to describe model discovery
generically instead of naming internal proxy endpoint paths, which
removes the `/v1` base-path contradiction flagged in review.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@c0ffeeca7 c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Jun 4, 2026

@c0ffeeca7 c0ffeeca7 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for contributing 💪

Please restore the original PR template (see PULL_REQUEST_TEMPLATE.md)

@home-assistant

home-assistant Bot commented Jun 4, 2026

Copy link
Copy Markdown

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

@home-assistant
home-assistant Bot marked this pull request as draft June 4, 2026 05:39
@luismalves

Copy link
Copy Markdown
Contributor Author

Should be fixed now @c0ffeeca7 , thanks for pointing ou!

@luismalves
luismalves requested a review from c0ffeeca7 June 4, 2026 10:08
@luismalves
luismalves marked this pull request as ready for review June 4, 2026 10:17
luismalves and others added 2 commits June 4, 2026 14:34
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread source/_integrations/litellm.markdown
Comment thread source/_integrations/litellm.markdown Outdated
Comment thread source/_integrations/litellm.markdown Outdated
@home-assistant
home-assistant Bot marked this pull request as draft June 5, 2026 06:38
luismalves and others added 3 commits June 5, 2026 09:36
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@luismalves
luismalves marked this pull request as ready for review June 5, 2026 08:43
@home-assistant
home-assistant Bot requested a review from c0ffeeca7 June 5, 2026 08:43
Comment thread source/_integrations/litellm.markdown Outdated
Comment thread source/_integrations/litellm.markdown
@home-assistant
home-assistant Bot marked this pull request as draft June 5, 2026 10:23
luismalves and others added 4 commits June 5, 2026 14:45
Accepting suggestion to clarify this section

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Accepting suggestion to clarify this section

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Remove the separate "Adding a conversation agent" heading and present
those steps as part of the setup flow. Move prerequisites above the
configuration section and restore a "Supported functionality" section.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@luismalves
luismalves marked this pull request as ready for review June 6, 2026 09:49
@home-assistant
home-assistant Bot requested a review from c0ffeeca7 June 6, 2026 09:49
c0ffeeca7
c0ffeeca7 previously approved these changes Jun 6, 2026

@c0ffeeca7 c0ffeeca7 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you, @luismalves 👍

@c0ffeeca7 c0ffeeca7 added the awaits-parent Awaits the merge of an parent PR label Jun 6, 2026
@home-assistant home-assistant Bot added the parent-merged The parent PR has been merged already label Jul 17, 2026
Comment thread source/_integrations/litellm.markdown Outdated
@home-assistant
home-assistant Bot marked this pull request as draft July 17, 2026 10:02
@luismalves
luismalves marked this pull request as ready for review July 17, 2026 11:24
@home-assistant
home-assistant Bot requested review from c0ffeeca7 and joostlek July 17, 2026 11:24
@silamon
silamon merged commit 7805df9 into home-assistant:next Jul 18, 2026
7 checks passed
@home-assistant home-assistant Bot removed awaits-parent Awaits the merge of an parent PR parent-merged The parent PR has been merged already labels Jul 18, 2026
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 19, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

has-parent This PR has a parent PR in another repo new-integration This PR adds documentation for a new Home Assistant integration next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants